glRect(3G)		       OpenGL Reference			    glRect(3G)



NAME
     glRectd, glRectf, glRecti,	glRects, glRectdv, glRectfv, glRectiv,
     glRectsv -	draw a rectangle


C SPECIFICATION
     void glRectd( GLdouble x1,
		   GLdouble y1,
		   GLdouble x2,
		   GLdouble y2 )
     void glRectf( GLfloat x1,
		   GLfloat y1,
		   GLfloat x2,
		   GLfloat y2 )
     void glRecti( GLint x1,
		   GLint y1,
		   GLint x2,
		   GLint y2 )
     void glRects( GLshort x1,
		   GLshort y1,
		   GLshort x2,
		   GLshort y2 )


PARAMETERS
     x1, y1 Specify one	vertex of a rectangle.

     x2, y2 Specify the	opposite vertex	of the rectangle.

C SPECIFICATION
     void glRectdv( const GLdouble *v1,
		    const GLdouble *v2 )
     void glRectfv( const GLfloat *v1,
		    const GLfloat *v2 )
     void glRectiv( const GLint	*v1,
		    const GLint	*v2 )
     void glRectsv( const GLshort *v1,
		    const GLshort *v2 )


PARAMETERS
     v1	  Specifies a pointer to one vertex of a rectangle.

     v2	  Specifies a pointer to the opposite vertex of	the rectangle.

DESCRIPTION
     glRect supports efficient specification of	rectangles as two corner
     points.  Each  rectangle command takes four arguments, organized either
     as	two consecutive	pairs of (x,y) coordinates, or as two pointers to
     arrays, each containing an	(x,y) pair.  The resulting rectangle is
     defined in	the z=0	plane.




									Page 1






glRect(3G)		       OpenGL Reference			    glRect(3G)



     glRect(x1,	y1, x2,	y2) is exactly equivalent to the following sequence:

	  glBegin(GL_POLYGON);
	  glVertex2(x1,	y1);
	  glVertex2(x2,	y1);
	  glVertex2(x2,	y2);
	  glVertex2(x1,	y2);
	  glEnd();

     Note that if the second vertex is above and to the	right of the first
     vertex, the  rectangle is constructed with	a counterclockwise winding.

ERRORS
     GL_INVALID_OPERATION is generated if glRect is executed between the
     execution of glBegin and the corresponding	execution of glEnd.


SEE ALSO
     glBegin, glVertex




































									Page 2